home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / spritemon.man < prev    next >
Text File  |  1989-10-17  |  6KB  |  201 lines
  1.  
  2.  
  3.  
  4. SPRITEMON                 User Commands                 SPRITEMON
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      spritemon - X widget to display system events
  12.  
  13. SSYYNNOOPPSSIISS
  14.      sspprriitteemmoonn --[uuRRaaffvvppPPiioorrww] [--NN  _n_u_m]  [--ddiisskkss]  [--DD  _n_u_m]  [--TT
  15.      _i_n_t_e_r_v_a_l] [--AA _a_v_a_i_l_I_n_t_e_r_v_a_l] [--%%MM] [--HH _h_e_i_g_h_t]
  16.  
  17. OOPPTTIIOONNSS
  18.      --TT _i_n_t_e_r_v_a_l
  19.           Sets the interval at  which  the  display  is  updated.
  20.           Default is 5 seconds.
  21.  
  22.      --HH _h_e_i_g_h_t
  23.           Sets the height of each graph displayed.  Default is 40
  24.           pixels.
  25.  
  26.      --uu   Display CPU utilization on a scale from 0.0 to 1.0.
  27.  
  28.      --NN _n_u_m _C_P_U_s
  29.           Do CPU utilization for more than one CPU.
  30.  
  31.      --RR   Display the number of  remote  processes  belonging  to
  32.           this host (in 10's).
  33.  
  34.      --aa   Display the number of hosts  to  which  this  host  can
  35.           migrate (in 10's).
  36.  
  37.      --AA _a_v_a_i_l_I_n_t_e_r_v_a_l
  38.           Sets the interval at which the count of available hosts
  39.           is updated. Default is 15 seconds.
  40.  
  41.      --ff   Display file system cache size.
  42.  
  43.      --vv   Display amount of physical memory devoted to user  vir-
  44.           tual memory.
  45.  
  46.      --%%   Display cache size (--ff) or VM size (--vv) as a percentage
  47.           of main memory.
  48.  
  49.      --MM   Display cache size (--ff) or VM size (--vv) in megabytes.
  50.  
  51.      --pp   Display the number of page-ins (in 100's).  This  is  a
  52.           sum of text, heap, and stack page-ins.
  53.  
  54.      --PP   Display the number of pages written out to  swap  files
  55.           (in 100's).
  56.  
  57.      --ii   Display the number of  ethernet  packets  received  (in
  58.           100's).
  59.  
  60.  
  61.  
  62.  
  63. Sprite v.1.0       Printed:  October 17, 1989                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SPRITEMON                 User Commands                 SPRITEMON
  71.  
  72.  
  73.  
  74.      --oo   Display the number of ethernet  packets  sent  out  (in
  75.           100's).
  76.  
  77.      --ddiisskkss
  78.           Display disk statistics for all  disks  in  the  system
  79.           (superceeds -D).
  80.  
  81.      --DD _n_u_m
  82.           Display disk #_n_u_m utilization on a scale  from  0.0  to
  83.           1.0.
  84.  
  85.      --rr   Display the number of disk read transfers  (in  100's).
  86.           Use with --DD or --ddiisskkss.
  87.  
  88.      --ww   Display the number of disk write transfers (in  100's).
  89.           Use with --DD or --ddiisskkss.
  90.  
  91. _________________________________________________________________
  92.  
  93. IINNTTRROODDUUCCTTIIOONN
  94.      This widget displays operating system parameters as  a  run-
  95.      ning  graph.   It  is an X toolkit widget and so it needs to
  96.      run under the X window system.  This is a  ``load  widget'',
  97.      which  displays  a  value  every _i_n_t_e_r_v_a_l seconds, and has a
  98.      title but no vertical scale.  Instead, horizontal lines  are
  99.      drawn to represent increments in the native unit of whatever
  100.      is being displayed.  For some parameters, like percentage of
  101.      memory devoted to the file system cache, the displayed value
  102.      is always between 0 and 1 so there are no  horizontal  scale
  103.      lines.   For the megabytes of filesystem cache there will be
  104.      horizontal  lines  that  represent  megabytes,  for   remote
  105.      processes  there  will be horizontal lines to represent 10's
  106.      of remote processes, and  for  paging  and  network  traffic
  107.      there will be horizontal lines to represent 100's of events.
  108.      The value displayed is truncated to the largest  value  that
  109.      can  be  displayed  without  causing the horizontal lines to
  110.      completely occupy the display.  This value is equal to  half
  111.      the pane height.
  112.  
  113.      Several system parameters can be viewed at  once;  the  load
  114.      meters are organized into a vertical pane with each meter of
  115.      equal height.  It is best to let spritemon determine its own
  116.      geometry  at  startup  (it  will use the default pane height
  117.      times the number of parameters being displayed), or you  can
  118.      specify  a  geometry  argument on the command line and spri-
  119.      temon will evenly divide the window into panes.   Otherwise,
  120.      if  you drag out a window size, the VPane widget does a poor
  121.      job of picking the heights of individual panes.
  122.  
  123.      The disk related options only work on machines  with  disks.
  124.      The  --DD  option  specifies which disk to display information
  125.      about, or --ddiisskkss can be used to  display  information  about
  126.      all  the disks in the system.  Utilization is displayed, and
  127.      --rr and --ww are used to display raw  read  and  write  counts.
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  October 17, 1989                   2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. SPRITEMON                 User Commands                 SPRITEMON
  139.  
  140.  
  141.  
  142.      The  number  to  specify to --DD corresponds to a kernel table
  143.      entry that is indexed starting at zero.
  144.  
  145. BBUUGGSS
  146.      The --ii option needs to  be  glommed  together  with  another
  147.      option,  i.e.  --iioo,  or it gets interpreted by the X toolkit
  148.      and sspprriitteemmoonn starts out iconic.
  149.  
  150.      The value of the argument to --DD is un-intuitive.
  151.  
  152.      The disk information should display the  file  system  name,
  153.      but kernel support is needed for this.
  154.  
  155. SSEEEE AALLSSOO
  156.      vmStat, migcmd
  157.  
  158. KKEEYYWWOORRDDSS
  159.      system, page faults, file system cache, virtual memory, net-
  160.      work interface, migration
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0       Printed:  October 17, 1989                   3
  198.  
  199.  
  200.  
  201.